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A method and apparatus for performing distributed 
object calls uses proxies and memory allocation and 
deallocation. Specifically, an object reference to an 
object is obtained. The object reference is used to create 
a proxy handle data structure that will represent the 
object. The proxy handle is passed to a client application 
stub function which calls the object The stub function 
is also passed input and output parameters along with 
exception information. An object request broker finds an 
appropriate implementation in a server application. The 
server application allocates memory for implementing the 
call. The object is implemented and the memory allocated 
by the server application is deallocated. The server 
application responds to the client, whereupon the client 
makes another object call using the same proxy handle or 
destroys the proxy handle. Multiple initialization of object 
calls is avoided because the object call can be initialized 
just once for a particular object. Moreover, resources are 
preserved by minimizing wild pointers and memory leaks 
that can occur during the calling and implementation of 
objects. 
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METHOD AND APPARATUS FOR PERFORMING 
DISTRIBUTED OBJECT CALLS USING 
PROXIES AND MEMORY ALLOCATION 

BACKGROUND OF THE INVENTION 

1. Field of the Invention 

The present invention relates to a method and apparatus for performing distributed 
5 object calls using proxies on the client side and memory allocation on the server side. 
Specifically, the method involves the creation of a proxy handle data structure to be 
associated with a particular object and its associated object reference. On the client side, 
object calls to the associated object are then made using the proxy handle, thus allowing 
multiple calls to the same object and eliminating the need to perform certain initialization 
10 functions each time the call is made. On the server side, the server allocates memory in a 
platform-independent manner. 

2. Background 

Distributed object computing combines the concepts of distributed computing and 
15 object-oriented computing. Distributed computing consists of two or more pieces of 
software sharing information with each other. These two pieces of software could be 
running on the same computer or on different computers connected to a common network. 
Most distributed computing is based on a client/server mode. With the client/server model, 
two major types of software are used: client software, which requests the information or 
20 service, and server software, which provides or implements the information or service. 

Object-oriented computing is based upon the object model where pieces of code 
called "objects"-often abstracted from real objects in the real world-contain data (called 
"attributes'* in object-oriented programming parlance) and may have actions (also known as 
"operations") performed on it. An object is defined by its interface (or "class" in C+ + 
25 parlance). The interface defines the characteristics and behavior of a kind of object, 
including the operations that can be performed on objects of that interface and the 
parameters to each operation. A specific instance of an object is identified within a 
distributed object system by a unique identifier called an object reference. 

In a distributed object system, a client application sends a request (or "object call") 
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to a server application. The request contains an indication of the operation to be performed 
on a specific object, the parameters to that operation, the object reference for that object, 
and a mechanism to return error information (or "exception information") about the success 
or failure of a request. The server application receives the request and carries out the 
5 request via a server "implementation. " The implementation satisfies the client's request for 
an operation on a specific object. The implementation includes one or more methods, which 
are the portions of code in the server application that actually do the work requested of the 
implementation. If the implementation is carried out successfully, the server application 
may return a response to the client. The server application may also return exception 
10 information. 

To standardize distributed object systems, the Object Management Group ( u OMG"), 
a consortium of computer software companies, proposed the Common Object Request 
Broker Architecture ("CORBA w ). Under the CORBA standard, an Object Request Broker 
("ORB") provides a communication hub for all objects in the system passing the request to 

15 the server and returning the response to the client. Commercial ORB's are known in the art 
and a common type is IBM's System Object Model ("SOM"). On the client side, the ORB 
handles requests for the invocation of a method and the related selection of servers and 
methods. When a cliept application sends a request to the ORB for a method to be 
performed on an object, the ORB validates the arguments contained in the request against 

20 the interface for that object and dispatches the request to the server , starting it if necessary. 
On the server side, the ORB uses information in the request to determine the best 
implementation to satisfy the request. This information includes the operation the client is 
requesting, what type of object the operation is being performed on, and any additional 
information stored for the request. In addition, the server-side ORB validates each request 

25 and its arguments. The ORB is also responsible for transmitting the response back to the 
client. 

Both the client application and the server application must have information about 
the available interfaces, including the objects and operations that can be performed on those 
objects. To facilitate the common sharing of interface definitions, OMG proposed the 
30 Interface Definition Language ( U IDL"). IDL is a definition language (not a programming 
language) that is used to describe an object's interface; that is, the characteristics and 
behavior of a kind of object, including the operations that can be performed on those 
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objects. 

IDL is designed to be used in distributed object systems implementing OMG's 
CORBA Revision 2.0 specification. In a typical system implementing the CORBA 
specification, interface definitions are written in an IDL-defined source file (also known as a 
5 "translation unit*). The source file is compiled by an DDL compiler that generates 
programming-language-specific files, including client stub files, server stub files, and header 
files. Client stub files are language-specific mappings of IDL operation definitions for an 
. object type into procedural routines, one for each operation. When compiled by a language- 
specific compiler and linked into a client application, the stub routines may be called by the 

10 client application to invoke a request. Similarly, the server stub files are language-specific 
mappings of IDL operation definitions for an object type (defined by an interface) into 
procedural routines. When compiled and linked into a server application, the server 
application can call these routines when a corresponding request arrives. Header files are 
compiled and linked into client and server applications and are used to define common data 

15 types and structures. 

In a system implementing the CORBA specification, object calls are made by calling 
the appropriate client stub function. The parameters to these stub functions typically include 
the input parameters for the requested operation and the object reference of the object. The 
CORBA specification, however, has certain performance-related drawbacks. First, each 

2 0 time an object is called, certain configuration operations must be performed. For instance, 
the object must be validated to ensure its existence. In addition, memory (or another 
resource) is often allocated for the call. The interface must be determined. Finally, 
transport of the call is prepared (e.g., opening files, preparing sockets, etc...). Performing 
each of these operations prior to each object call can be very time-consuming. In a time- 

25 critical application, the overhead associated with each object call can significantly affect 
performance. 

Further, on the server side, performance is affected by the improper allocation and 
deallocation of memory ("garbage collection"). In many distributed object systems, 
memory can be allocated for the implementation of an object call. Once the implementation 
30 y ha s been performed and the server responds to the call, however, memory is not 
automatically deallocated. This failure to deallocate memory leads to wasted resources and, 
therefore, slower performances. In addition, the failure to remove pointers or addresses 
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pointed to by pointers can lead to larger problems, such as system errors and application 
shutdowns. 

Certain systems have attempted to use garbage collection in the implementation of 
object calls. Those systems, however, use platform-specific methods for deallocating 
5 memory. Thus, code portability is often sacrificed in favor of proper memory allocation 
and deallocation. 

Accordingly, a need exists for a method for improving object call performance by 
eliminating the need to configure an object call each time the same object is called. 

Further, a need exists for a platform-independent method for improving object call 
10 performance by allocating and deallocating memory during object implementation. 

SUMMARY OF THE INVENTION 

The present invention provides a method arid apparatus for performing object calls 
that improves performance by eliminating the need to configure an object call each time the 

15 same object is called. The present invention also improves object call performance by 
allocating and deallocating memory during object implementation. 

More particularly, the present invention is directed to a method for calling an object 
via a generated stub function within a client application to a serjver application. The call is 
performed by first obtaining an object reference that refers to the object. Next, the object 

20 reference is used to create a proxy handle to represent the object in calls to the object. The 
object is then called via the stub function. The stub function is passed the proxy handle, an 
input parameter of an operation to be performed on the object, an output parameter of the 
operation, and exception information. The object is then implemented via a method function 
in the server application. The server application responds to the caller and completes the 

25 call. The proxy handle may be used again for a subsequent call to the same object. Once 
the final object call has been made, the proxy handle is destroyed. 

The creation of the proxy handle automatically allocates resources for the object call. 
When the proxy handle is destroyed, those resources are freed. Moreover, since the proxy 
handle can be used for multiple calls to the same object, the client application is not required 

30 to perform any initialization that may have been performed during the previous object calls. 
For instance, object validation, file opening, and socket preparation are events that are 
commonly performed during each object call. These initialization events may be placed in a 
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time-critical portion of the application to save resources. Finally, Trwltiple proxy handles 
may be used for the same object to force users to comply with certain requirements before 
implementing a particular feature of an object. In this manner, files and similar objects may 
be pseudo-encry pted . 

5 In an alte .native embodiment, resources may be allocated and deallocated during the 

actual implementation of the object. In this embodiment, the method function in the server 
application calls a function to allocate the appropriate resources. The function returns a 
pointer to memory that has been allocated on the heap in the server computer. Upon 
completion of the method function, the memory is automatically deallocated. Automatic 

10 deallocation of memory reduces the likelihood of random pointers and memory leaks that 
can often occur during the implementation of an object. 

A more complete understanding of the method and apparatus for performing object 
calls will be afforded to those skilled in the art, as well as a realization of additional 
advantages and objects thereof, by a consideration of the following detailed description of 

15 the preferred embodiment. Reference will be made to the appended sheets of drawings 
which will first be described briefly. 

BRIjEF DESCRIPTION OF THE DRAWINGS 

Fig. 1 is a block diagram of a client/server computing system utilizing the method of 
20 the present invention. 

Figs. 2a and 2b are diagrams of alternative Common Execution Environment capsule 
configurations. 

Fig. 3 is a diagram of a Common Execution Environment capsule and its core 
components; 

25 Fig. 4 is a diagram of the compilation and linking of IDL source code into client and 

server applications. 

Fig. 5 is a flow chart describing the steps involved in the method of the present 
invention. 

Fig. 6 is a flow chart describing the steps involved in an alternative embodiment of 
30 the method of the present invention. 

Fig. 7 is a diagram showing a PIF data structure. 
Fig. 8 is a diagram showing an entry data structure. 
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Fig. 9 is a diagram showing an operation data structure. 
Fig. 10 is a diagram showing a union data structure. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

5 Reference will now be made in detail to the preferred embodiments of the invention, 

examples of which are illustrated in the accompanying drawings. Wherever possible, the 
same reference numbers will be used throughout the drawings to refer to the same or like 
parts. 

10 I. System Overview 

As illustrated in Figure 1 , the method of the present invention is designed for use in 
a distributed (client/server) computing environment 10. The client and server systems are 
connected by network connections 12, such as internet connections or the connections of a 
local area network. The server computer 11 communicates over a bus of I/O channel 20 
15 with an associated disk storage subsystem 13. The server system 1 1 includes a CPU 15 and 
a memory 17 for storing current state information about program execution. A portion of 
the memory 17 is dedicated to storing the states and variables associated with each function 
of the program which is currently executing on the client computer. The client computer 21 
similarly includes a CPU 27 and associated disk memory 23, and an input device 29 , such as 
20 a keyboard or a mouse and a video display terminal ("VDT") 33. The client CPU 
communicates over a bus or I/O channel 40 with a disk storage subsystem 33 and via I/O 
channel 41 with the keyboard 29, VDT 33 and mouse 31. Both computers are capable of 
reading various types of media, including floppy disks and CD-ROMs. 

The client memory 27 includes a client application 77 and client stubs 79 loaded 
. 25 therein. Similarly, the server memory 17 includes a server application 87 and server stubs 
89. In addition, both the client memory and the server memory include an execution 
environment 75, 85 (as discussed below). 

The client/server model as shown in Figure 1 is merely demonstrative of a typical 
client/server system. Within the context of the present invention, the "client* is an 
30 application that requests that operations be performed on an object while the 44 server n is an 
application that implements the operation on the object. Indeed, both the client and server 
application may reside on the same computer and within a common capsule, as discussed 

6 
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below. Most likely, however, the client and server application will reside on separate 
computers using different operating systems. The method of the present invention will be 
discussed with reference to two capsules running on separate machines. 

The method and apparatus of the present invention may be utilized within any 
5 distributed computing environment. In a preferred embodiment, the Common Execution 
Environment ("CEE"), which is a component of the Tandem Message Switching Facility 
("MSF") Architecture is used. The CEE activates and deactivates objects and is used to 
pass messages between client and server applications loaded in CEE capsules. The CEE 
may be stored in the memory of a single machine. More likely, however, the CEE and 

10 client and server applications will be loaded on multiple machines across a network as 
shown in Figure 1. The client-side CEE 75 is stored in the client memory 27. The server- 
side CEE 80 is stored in server memory 17. 

The CEE uses a ^capsule" infrastructure. A capsule encapsulates memory space and 
execution stream. A capsule may be implemented differently on different systems 

15 depending upon the operating system used by the system. For instance, on certain systems, 
a capsule may be implemented as a process. On other systems, the capsule may be 
implemented as a thread. Moreover, client and server applications may be configured 
within different capsules contained on different machines as <jhown in Figure 1. 
Alternatively, the different capsules may be configured as shown in Figure 2. Figure 2a 

20 shows a client application 79 loaded in a single capsule and a server application 89 may be 
loaded in a separate capsule 85. Both capsules, however, are stored on the same machine. 
Both the client and server applications may also be loaded within a single capsule 81 on the 
same machine 21 as shown in Figure 2b. As stated above, the method of the present 
invention will be described with reference to the multiple capsule, multiple machine case. 

25 Accordingly, the client 12 and server machine 11 include a client-side CEE 75 and a server- 
side CEE 85 loaded in their respective memories. 

Figure 3 shows a CEE capsule 70 contained in a client computer memory 27 (not 
shown) that includes the CEE 75 and certain of the core CEE components and 
implementations of objects contained within Implementation Libraries 71. The 

30 Implementation Libraries 71 include the client application 79 (or the server application in the 
case of the server capsule) and client stubs 77 generated from the IDL specification of the 
object's interface, as described below. The Implementation Libraries 71 and the CEE 75 
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interact through the down-calling of dynamically-accessible routines supplied by the CEE 
and the up-calling of routines contained in the Implementation Library. The CEE 75 can 
also receive object calls 82 from other capsules within the same machine and requests 84 
from other CEE's. The client-side CEE 75 and the server-side CEE 85 may communicate 
5 using any known networking protocol. 

Objects implemented in a CEE capsule may be configured or dynamic. Configured 
objects have their implementation details stored in a repository (such as the MSF Warehouse 
85) or in initialization scripts. Given a request for a specific object reference, the CEE 75 
starts the appropriate capsule based on this configuration data. The capsule uses the 

10 configuration data to determine which Implementation Library to load and which object 
initialization routine to call. The object initialization routine then creates the object. 
Dynamic objects are created and destroyed dynamically within the same capsule. Dynamic 
objects lack repository-stored or scripted configuration information. 

The following paragraphs describe a system-level view of how the Implementation 

15 Libraries interacts with the CEE 75. The CEE 75 implements requests to activate and 
deactivate objects within a capsule. In addition, the CEE facilitates inter-capsule object calls 
83 as well as requests from other CEE's 87, as discussed above. Object activation requests 
arise when an object call froroj a client or server application must be satisfied. To activate 
an object, the CEE 75 loads the appropriate Implementation Library (if not already loaded) 

2 0 containing the object's methods and then calls a configured object initialization routine. The 
initialization routine specifies which interface it supports and registers the entry points of the 
object's methods to be called by the CEE at a later time. 

When the client and server systems start, the CEE runs its own initialization. This 
initialization tells client and server CEE*s where to locate the various Implementation 

25 Libraries. Once located by the CEE, the initialization routines in the client and server 
applications are called. The initialization routines contained in the client and server 
applications must first carry out any required application-specific initialization. Next, both 
the client and server initialization routines down-call a CEE function (contained in a 
dynamic library as stated above) called CEE_INTERFACE_CREATE to specify the object's 

30 interface. The interface description is normally generated from an IDL description of the 
interface contained in an IDL source file, as discussed below. 
CEEJNTERFACECREATE creates an interface and returns a handle to the newly created 
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interface. The handle is a unique identifier that specifies the newly-created interface. The ■> 
server application initialization routine then uses the interface handle to down-call 
CEE_IMPLEMENTATION_GREATE. CEEJMPLEMENTATION_CREATE creates an 
implementation description that can be used by one or more objects. 
5 CEEJMPLEMENTATION^CREATE returns an implementation handle that is a unique 
identifier specifying the implementation for each operation in the interface. Finally, the 
server application initialization routine uses the implementation handle to call 
CEE_SET_METHOD and specifies the actual addresses of specific method routines of the 
implementation as contained in the server application. The CEE then has sufficient 
10 information to connect object calls in the client application to specific methods in the server 
application. 

Figure 4 shows how IDL source files are compiled and linked into client and server 
applications that will utilize the method and apparatus of the present invention. First, an 
IDL source file 101 is prepared containing IDL interface definitions. An DDL compiler 103 

15 compiles the source file 101. The IDL compiler 103 parses the code 101 to produce a 
Pickled IDL file (*PIF W ) file 105 for storage of the compiled source code. A code 
generator 111 then parses the PIF file. The generation of a PIF file is described below in 
Section IV. The code generator 111 generates files in the language of the client and server 
applications. If the client and server applications are in different languages, different code 

20 generators are used. Preferably, the code generator 111 and IDL compiler 103 may be 
combined in a single application to produce language-specific code. The code generator 111 . 
produces a client stub file 115 containing client stub functions and a server stub file 117 
containing definitions for object implementations. The client stub functions include 
synchronous and asynchronous calls to the CEE. The client stub file 115 and the server stub 

25 file 117 are compiled by programming language-specific compilers 121, 123 to produce 
compiled client stub object code and compiled server stub object code. Similarly, a client 
application 79 and a server application 89 are compiled by programming-Ianguage-specific 
compilers to produce compiled client application object code and compiled server 
application object code. The client application 121 and the server application 123 also 

30 include a header file 119 generated by the code generator 111. The header file 119 contains 
common definitions and declarations. Finally, the compiler 121 links the client application 
object code and the client stub object code to produce an implementation library 71. 
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Similarly, a second compiler links the server application object code server stub object code 
to produce another implementation library 81. 

II. Proxy Creation 

5 Now, with reference to Figures 5 and 6, the method of the present invention will be 

described. The method of the present invention will be described with reference to a client 
application executing in a capsule on a client computer and a server application executing in 
a separate capsule on a server computer. Figure 5 is a flow chart depicting the steps 
involved in utilizing a proxy handle to call an object. In a first step 501, an object reference 

1 0 for the desired object must be obtained. The object reference may be obtained in a number 
of ways. Client applications usually receive the reference from configuration data, 
directories or invocations on other objects to which they have object references. An object 
reference can be converted to a string name that can be stored in files to be accessed later. 

Once the object reference has been obtained, the object call may be performed. In 

15 the method of the present invention, the object call is performed by first obtaining a "proxy 
handle" to the object reference. The proxy handle is a unique identifying data structure (a 
"proxy object") for a particular object reference. The proxy structure contains information 
about an object and calls to that object. Calls can be made to the specified object using the 
proxy handle. The proxy handle facilitates calls to the same object and prevents overhead 

20 that occurs in multiple calls to the same object. By creating a proxy handle via which object 
calls can be made, certain initialization routines may be performed once through the proxy 
handle while allowing multiple calls to the proxied object. In addition, the proxy handle 
facilitates the use of asynchronous calls to an object (discussed below). In a preferred 
embodiment, a proxy handle is created in step 503 by down-calling the client-side CEE 

25 function, CEEPRQXYjCREATE, in the client application. That function is defined in the 
C programming language as follows: 
CEEJPROXY_CREATE ( 

const char "objref, 
const char *intfjiandle, 

3 0 char *proxyJiandle) ; 

The function receives the object reference, objref, and an interface handle, intfjiandle, and 
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returns a proxy handle identifying the newly created proxy object. As discussed above, in 
connection with Figure 3, an interface must be created for each object. An interface defines 
the operations available for a collection of similar objects. The interface is defined in IDL 
and compiled and Linked into a client application. The client application calls 
5 CEEJDNTTERFACE CREATE in its initialization routine to specify the interface. The 
client-side CEE returns an interface handle that can be used to create any number of objects 
or proxies. 

In a preferred embodiment of the present invention, the proxy object is represented 
by a structure containing the following fields: 
10 link; 

calljink; 
self; 
nor; 
state; 

15 call active; 

destroy; 
lockcount; 

*intf; j 

calijiompljrtn; 
20 callxompljagl; 

calljcompltjag2; 

call_compljsts; 

operationjdx; 

^client jdlocated j>arams; 
25 ^server allocated j?arams; 

*obj; 

operationjdx Jable; 
max^responsejize; 
*reqjirea; 
30 *rsp_area; 

*rsp j>aram_buf\ 
ochan; 
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Each of the components of the proxy object data structure will now be discussed. 
The addresses and values stored in each of these components is modified by the client-side 
CEE with each call to the object referred to by the proxy structure. The client-side CEE 
5 maintains a linked list of proxy structures. The link member of each proxy structure 
contains a pointer to the next entry in this list of proxy structures. 

In a preferred embodiment, object calls can be either synchronous (client application 
requests that an operation be performed on an object and waits for a response) or 
asynchronous (client application requests that an operation be performed on an object and 

10 continues to do other work). When asynchronous object calls are dispatched in the same 
capsule, each call is queued onto a linked list contained in an object structure that exists for 
every object when activated. The call Jink parameter is a link to the list of calls. The self 
member is the handle of this particular proxy structure. This handle is returned to the client 
during CEE_PROXY_CREATE. 

15 The object reference passed to CEEJ?ROXY_CREATE is stored in the nor 

member. The state parameter indicates whether the proxy structure includes a pointer to an 
internal object structure, an external object (via a client port), or a non-existing object 
sthicture (is stale). If the proxy is internal, a pointer to the object is contained in the obj 
parameter. If the object is in a different capsule, the ochan parameter contains a pointer to a 

20 client port handle or other information required to communicate with the object/ 

The calljtctive member holds a true/false value. The calljzctive member is set to 
true if an object call is outstanding for this particular proxy handle. Only one object call can 
be outstanding on a given proxy. The tock_count member is incremented to prevent the 
proxy structure from being destroyed. It is decremented when the structure is no longer 

25 needed. The destroy member is a true/false value that is set to true if this proxy structure 
should be destroyed when lockjcount drops to zero. The intf member is the address of the 
intf structure that describes the interface (discussed above). 

The next four structure members, calljcortpljln, callj:ompljagl y 
call_compl_tag2 y callcompljts, are used to implement asynchronous object calls. 

30 Asynchronous calls to an object in a server application are made by passing the address of a 
completion routine to the client stub function when called. The client stub function, in turn, 
calls the client-side CEE and provides the completion function address. The client-side CEE 



12 



WO 98/02812 



PCT/US97/11886 



stores the completion function address in the proxy structure upon creation of the proxy 
handle. When the object call completes, the client-side CEE calls the completion routine 
specified in the proxy handle. The routine is called to notify the client application that the 
call has completed. While the object is being implemented, the client application can 
5 continue performing other functions. The member calljcompljin contains the address of 
the completion routine. Since multiple calls may be made to the same proxied object, the 
client application can identify the call by using the call jnmpljagl parameter when the 
object call is made. The calLcomplJagl identifier is passed to the client stub function. 
These identifiers are specified in the proxy structure by the members callcompljagl and 
10 calljcompljag2. The callcompljts indicates the call completion status for asynchronous 
calls that could not be called. 

The operation Jdx member specifies which of the object's operations is to be called. 
Operation identifiers are generated by the code generator for each operation in the interface. 
The allocated jararns member is a pointer to the parent of temporarily allocated 
15 parameters (used for unbounded types and the like). The deallocation of this member 
performs garbage collection on the next call to the object referenced by this proxy structure. 
The operation Jdx Jable parameter is a pointer to an operation index translation table that is 
used only if the object is contained in the same capsule. j 

Memory allocation is performed utilizing the max response size, req area, 
20 rsparea, and rsp j>aramj>uf members. The rsp jparqmbuf member points to a buffer 
containing the response parameters. The next time that this proxy object is used, the buffer 
will be deallocated. The max response jsize member is the maximum expected response 
size. This is used to allocate the rsp jirea member. The req_area member points to an 
area structure that will be used for the request. The rsp area points to an area structure 
25 that will be used for the response to the object call. The area structure contains the 
following fields, as defined in C: 

desc; 

*data; 

curlen; 

30 

The area structure contains an object call area descriptor and a pointer to data and the 
current length of that data. 
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The call by the client application to CEE_PROXY_CREATE causes the client-side 
CEE to automatically allocate memory for the object call in step 508. Memory in the client 
computer is allocated along with any additional resources necessary for making the call. 
Once the proxy handle is destroyed (through a down-call to CEE_PROXY_DESTROY, 
5 discussed below), the memory and any allocated resources are freed. Memory allocated for 
variable-sized output parameters from an object call are deallocated when the next object call 
is made using the same proxy handle. 

The proxy handle is used to make all subsequent calls to the object referred to by the 
proxy. The object call is made in step 511 by calling the appropriate stub function in the 
10 client application and passing the proxy handle and input and output parameters along with 
exception information to the function. The stub function, in turn, downfalls 
CEEJ3BJECT_CALL, defined in C as follows: 
CEE_OBJECT_CALL ( 

const char *proxy handle, 

15 long operation Jdx, 

void +*param yectdr); 

The proxy handle is specified by the proxy handle parameter. The parameter operation Jdx 
specifies which of the object's methods is to be called. This parameter is an index to the 

20 required method in the interface description that was supplied when the interface was 
created. Finally, the paramjector parameter is an array of pointers to the object call's 
input parameters, output parameters, and exception structure. The address of the exception 
structure is the first element in the array. If the operation is not of type void, then the 
following element contains the address of the variable to receive the operation's result. 

25 Subsequent elements contain the addresses of the operation's input and output parameters in 
the same order as they were defined in IDL. 

The call is then transported to the server using any transport mechanism. In step 
515, the server application implements the object. This is performed by the server-side 
CEE which up-calls the appropriate method routine. The method routine is passed the 

30 paramjiector parameter containing the addresses of all the input and output parameters. 
When the method exits, a response is sent to the caller in step 519 and the object call is 
complete. 
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Once the first call has completed, the proxy handle may be used again to make 
further calls to the same object. Each subsequent call to the object may be made without 
validating the object or performing other start-up operations. Thus, the proxy creation step 
can be placed in a non-time-critical portion of the client application and object calls can be 
5 made in a time-critical portion of the application. 

Following the final object call for a specified proxy handle, the proxy handle is 
destroyed in step 521. This is accomplished by calling CEEPROXYDESTRO Y in the 
client application, defined in C as follows: 

CEE_PROXYDESTROY ( 
10 const char *proxy_handle); 

The proxy handle is passed to the function. The client-side CEE destroys the proxy handle 
and frees all previously-allocated resources for the proxy handle in step 528. Alternatively, 
an object call may be canceled and all of the resources associated with the call may be 
15 deallocated by destroying the proxy while the call is outstanding. 

III. Proxy Creation And Memory Allocation 

j Figure 6 shows an alternative embodiment of the object call method of the present 
invention. In this embodiment, memory is allocated during the implementation of the object 
20 as well as during the object call. 

Steps 601-611 are similar to the steps described above. Thus, in step 601, an object 
reference is obtained. Next, a proxy handle is obtained by down-calling 
CEEPROXYCREATE which returns the proxy handle. The object call is then made in 
step 611 using CEEOBJECTCALL, which is passed the proxy handle of the referenced 
25 object. 

In step 613, the server-side CEE up-calls the appropriate method routine in the 
server application. The method routine, in step 616 when called, down-calls a server-side 
CEE function to allocate memory. That function, CEE_TMP_ALLOCATE is defined in C 
as follows: 
30 CEETMPALLOCATE ( 

const char *calljd t 
long len t 
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void **/?fr); 

The function uses the calljd parameter to track a particular object call. Each call to the 
object is given a unique calljd by the server application. Thus, once the call is made, the 
5 server implementation provides an id for the call in the calljd parameter. The number of 
bytes to allocate is specified in the ten parameter. The function returns the address of the 
allocated memory through the ptr parameter. 

The object's method is performed by the server application in step 619. The server 
application responds to the caller in step 615. Upon exiting the method function, the 
10 memory allocated under the down-call to CEE_TMP_AlXOCATE is freed in step 620. 
The client application then makes another object call in step 611 or destroys the proxy 
handle in step 625. If the proxy handle is destroyed, the memory allocated in step 609 is 
automatically deallocated by the client-side CEE in step 628. 

Memory can be prematurely deallocated using CEEjTMP_DEALLOCATE. That 
15 function is defined as: 

CEEJTMPJDEALLOCATE ( 

In void */?rr); 

The function is passed the ptr parameter that was provided by CEETMPALLOCATE. 
20 The CEE frees the address pointed to by that parameter. 

IV. Creating a Pickled IDL Format Data Structure 

The Pickled IDL Format ("PDF") data structure is designed to be used in conjunction 
with IDL compilers and code generators loaded in the client memory 23 and server memory 

25 17. The data structure is based upon an IDL source file stored in memory 23 or in memory 
17. The source file may also be contained on a computer-readable medium, such as a disk. 
The data structure of the present structure contains a parse tree representing the DDL source 
file. The data structure can be stored in memory 23 or in memory 17 or on a computer- 
readable medium, such as a disk. The data structure that represents the source file is 

30 referred to as a Pickled IDL Format (TEF"). The PIF file can be accessed at run-time by 
clients and servers that use the interfaces defined in the source file. The parse tree contained 
in the PIF file is an array using array indices rather than pointers. The use of array indices 
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permits the resulting parse tree to be language-independent. The first element of the array is 
unused. The second element of the array (index 1) is the root of the parse tree that acts as 
an entry point to the rest of the parse tree. 

The data structure, tu 701, is shown in Figure 7, and defined in DDL as follows: 
5 struct tudef { 

sequence < entry jdef> entry; 
sequence < string > source; 

. _ >■ . . ■ ■ 

10 The data structure 701 contains a sequence (a variable-sized array) of parse tree nodes 705, 
each of type entrydef (defined below) and a sequence of source file lines 707. The 
sequence of source file lines 707 is a sequence of strings containing the actual source code 
lines from the IDL source file. 

Each parse tree node (or "entry") 705 consists of a fixed part containing the name of 
15 the node and its properties as well as a variable portion that depends upon the node's type. 
The parse tree node is shown in Figure 8 and defined in IDL as follows: 
struct entry_def { 

unsigned long entry Jndex; j 
string name; 
20 string filename; 

unsigned long linejir; 
boolean injnain Jile; 
union ujag switch (entry Jypejief) { 

case entry_argument: argument_def argument_entry; 
25 case entry array: array_def array^entry; 

case entry_attr: attrjdef attr_entry; 
case entry_const: const_def constentry; 
case entry_enum: enumjief enum_entry; 
case entry_enurn_val: enum_val_def enumvalentry; 
30 case entry__except: except_def except_def_entry; 

case entry_field: field_def field_def entry; 
case entryjnterface: interfacejief interface_entry; 
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case entry jnterfacejwd: interface fwd_def interfacejwd_entry; 
case entry module: modulejlef module entry ; 
case entryop: opjlef op_entry; 

case entryjre ^defined: pre_defined_def predefinedentry ; 

case entry_sequence: sequence_def sequence_entry; 

case entiyjstring: stringjtef strihg_entry; 

case entry_struct: struct^def strucr entry; 

case entry_typedef: typedef_def typedefentry; 

case entry_union: union_def union_entry; 

case entry_union_branch: unionbranchdef unionJ>ranch_entry; 



The ftxed part of the parse tree node includes entry Jndex 805, an unsigned Long 
15 which is the index for this particular entry in the parse tree. The unqualified name of the 
entry is contained in the field name 807. The name of the original DDL source file is 
contained in the field file name 811. The field line nr 813 contains the line number in the 
IDL source filejthat caused this parse tree node to be created. The boolean injnain Jile 
815 indicates whether or not the entry is made in the IDL source file specified on the 
20 command line or whether the entry is part of an "include" file. Following these fields, the 
parse tree node includes a variable portion-a union 817 having a discriminator, 
entry jypejief. The union discriminator, entry Jypejief, specifies the type of node and 
which variant within entry def is active. Entry jypejief is an enumeration defined as 
follows: 

25 enum entry jypejief { 

entry jmused, 

entry module, 

entry ^interface, 

entry jnterfaceJFwd, 
30 entry_const, 

entry jexcept, 

entry_attr, 

18 * 
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entry_op, 
entryargument, 
entry_union, 
entry_union_branch, 
5 entry_struct, 
entry jfield, 

entry_enum, 
entryenumval, 
entry_string, 
10 entryarray, 

entry_sequence, 
entrytypedef, 
entry _pre_defnied 

15 

Entry jypejlef includes a list of the various types of parse tree entries. Each parse tree 
entry represents a constant integer that is used in the switch statement contained in 
entry jlef. For each entry, the union ujag will include a different type of structure. The 
. first enumerated value entryjinused corresponds to the value zero and is not used in 
20 determining the type of the union. 

If the parse tree entry is a module (specified by the value entry_moduie) the variable 
portion of the parse tree entry is a data structure including a sequence of module definitions; 
Each module definition is an unsigned long acting as an index in the parse tree array. 

If the parse tree entry is an interface, as specified by the value entryinterface, the 
25 variable portion of the parse tree is a data structure including a sequence of local definitions 
and a sequence of base interfaces from which this interface inherits. If the parse tree entry 
is a forward declaration of an interface (entry_interface_fwd), the union is an unsigned long 
containing the index of the full definition. 

Constants (entry jronst) are represented in a parse tree node as a structure containing 
30 the value of the constant. A union and switch/case statement are preferably used to 
discriminate between the various base type constants (boolean constant, char constant, 
double constant, etc...) that may be included in the source file. 
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Exceptions (entry_except) are represented in a parse tree node as a structure 
containing a sequence of fields. An attributes (entry _attr) is represented as a data structure 
containing a boolean value that indicates whether the attribute is read-only and an unsigned 
long that indicates the data type. 
5 If the parse tree entry is an operation (opdef), the variable portion 817 of the entry 

data structure 905 is a data structure as shown in Figure 9. The data structure 817 contains 
a boolean 905 that indicates whether or not the operation has a one-way attribute, an 
unsigned long 907 that indicates the return type, a sequence of arguments 909 to the 
operation, a sequence of exceptions 911 to the operation, and a sequence of strings 1313 that 

10 specify any context included in the operation. If the parse tree entry is an argument to a 
particular operation (entry ^argument), the variable portion of the parse tree entry is a 
structure containing unsigned longs that indicate the data type and direction of the argument. 

If the parse tree entry is a union (entry_union), it is represented in the parse tree 
entry as shown in Figure 10. The data structure 817 contains an unsigned long specifying 

15 the discriminator 1003 and an unsigned long specifying the type 1005. The type is 
preferably specified using an enumerated list of base types. The structure 817 further 
includes a sequence of the union's fields 1007, If the parse tree entry is a union branch 
(entryj)ranch), the variable portion of the parse treej entry is a structure containing an 
unsigned long indicating the base type of the branch, a boolean indicating whether or not the 

20 branch includes a case label, and the value of the discriminator. Since the value is of a 
particular data type, preferably ail enumerated list of the various base types is used to 
specify the value within the structure used to represent the union branch. 

For data structures (entrystruct), the variable portion of the parse tree entry 
includes a structure containing a sequence of the specified structure's fields. Enumerated 

25 values (entry_enum) are represented by a structure containing a sequence of enumerated 
values. Enumerations of an enumerated type (entry_enum_val) are represented in the parse 
tree entry by a structure containing an unsigned long holding the enumeration's numerical 
value. 

If the parse tree entry is a string (entry_string), the variable portion of the parse tree 
30 entry is a structure containing the string's maximum size. A maximum size of zero implies 
ah unbounded string. An array (entry array) is represented in the parse tree entry by a 
structure containing an unsigned long holding the array's base type and a sequence of longs 
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holding the array's dimensions. A sequence (entry_sequence) is represented by a structure 
containing unsigned longs holding the sequence's base type and the sequence's maximum 
size. 

For type definitions {entry Jypedef), the parse tree entry includes a structure 
5 containing an unsigned long value indicating the type definition's base type. Predefined 
types (entry _pre_defined) are represented by a structure containing the data type. To 
specify the type, preferably an enumeration of the various base types are used. 

Once the IDL source file has been described using the tu data structure, the data 
structure may be transported to a file or database using any known methods. 

10 

Having thus described a preferred embodiment of a method for making object calls 
using proxies and memory allocation/deallocation, it should be apparent to those skilled in 
the art that certain advantages of the within system have been achieved. It should also be 
appreciated that various modifications, adaptations, and alternative embodiments thereof 
15 may be made within the scope and spirit of the present invention. The invention is further 
defined by the following claims. 

) 
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CLAIMS 

What is Claimed is : 

5 1. A method for calling an object stored in a computer memory, the method 

comprising the steps of; 

obtaining an object reference that refers to the object, the object reference being 
obtained by a client application; 

creating a proxy handle data structure to represent the object, the data structure 
10 containing the object reference and, if the object is within a same process as the client 
application, a pointer to the object and, if the object is in a different process from the client 
application, a pointer to information required to communicate with the object; 

requesting that an operation be performed on the object via a stub function in the 
client application, the stub function being passed the proxy handle data structure and an 
15 input parameter of the operation; 

implementing the operation on the object in a server application; and 
responding to the client application. 

2. The method for calling an object, as recited in Claim 1, further comprising the 
20 step of destroying the proxy handle after the call has completed. 

3. The method for calling an object, as recited in Claim 1, further comprising the 
step of destroying the proxy handle while the call is outstanding. 

25 4. The method for calling an object, as recited in Claim 2, wherein the object call is 

performed using an execution environment accessible by the client application. 

5. The method for calling an object, as recited in Claim 5, wherein the step of 
creating the proxy handle is performed by the execution environment. 

30 

6. The method for calling an object, as recited in Claim 6, wherein the step of 
destroying the proxy handle is performed by the execution environment. 
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7. The method for calling an object, as recited in Claim 1, wherein the stub function 
is also passed an output parameter of the operation to be performed on the object. 

5 8. The method for calling an object, as recited in Claim 7, wherein the stub function 

is also passed exception information. 

9. The method for calling an object, as recited in Claim 1/ further comprising the 
steps of: 

10 allocating a block of memory in the computer memory for implementing the 

operation; and 

deallocating the block of memory in the computer memory following the 
implementation of the operation. 

15 10, The method for calling an object, as recited in Claim 9, wherein the block of 

memory is allocated by an execution environment accessible to the server application. 

11. The method for calling an object, as recited inj Claim 1, wherein the client 
application is stored in the computer memory. 

20 

12. The method for calling an object, as recited in Claim 1, wherein the client 
application is stored in a second computer memory. 

13. A method for calling an object stored in a computer memory, the method 
25 comprising the steps of: 

obtaining an object reference to refer to the object, the object reference being 
obtained by a client application; 

creating a proxy handle data structure to represent the object, the data structure 
containing the object reference and, if the object is within a same process as the client 
30 application, a pointer to the object and, if the object is in a different process from the client 
application, a pointer to information required to communicate with the object 

requesting that an operation be performed on the object via a stub function in the 
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client application, the stub function being passed the proxy handle, and an input parameter 
of the operation; 

allocating a block of memory in the computer memory to implement the operation on 
the object; 

5 implementing the operation on the object in the server application; 

deallocating the block of memory in the computer; 
responding to the client application; and 
destroying the proxy handle. 

10 14. The method for calling an object, as recited in Claim 13, wherein the step of 

creating a proxy handle data structure is performed by an execution environment accessible 
to the client application. ; 

15, The method for calling an object, as recited in Claim 14, wherein the step of 
15 destroying the proxy handle is performed by the execution environment. 

16. The method for calling an object, as recited in Claim 13, wherein the stub 
fiinction is also passed an output parameter of the operation to be performed on the object. 

20 17. The method for calling an object, as recited in Claim 16, wherein the stub 

function is also passed exception information. 

18. A computer program product, comprising: 

a computer useable medium having computer readable code means embodied therein 
25 for performing an object call, the computer readable program code means comprising: 

software means for obtaining an object reference that refers to the object, the object 
reference being obtained from within a client application; 

software means for creating a proxy handle data structure to represent the object, the 
data structure containing the object reference and, if the object is within a same process as 
30 the client application, a pointer to the object and, if the object is in a different process from 
the client application a pointer to information required to communicate with the object; 

software means for requesting that an operation be performed on the object via a stub 
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function in the client application, the stub function being passed the proxy handle data 
structure and an input parameter of the operation; 

software means for implementing the operation on the object in a server application; 

and 

software means for responding to the client application. 
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